Release 10.1A: OpenEdge Development:
Progress 4GL Reference

Server object handle

Allows you to connect and execute remote procedures on an AppServer or Web service.

Note: This handle does not provide direct access to an AppServer session context as does a SESSION handle for the current context. Rather, it provides access to a server object in the current context that allows you to connect, disconnect, and retrieve a variety of information on a connected AppServer.

Syntax

server-handle [ :attribute | :method ]

server-handle

A handle variable that references a server object created by the CREATE SERVER statement that, in turn, allows you to connect to and access an AppServer instance or a Web service application.

attribute

An attribute of the server handle.

method

A method of the server handle.

Attributes

ASYNC-REQUEST-COUNT attribute	CLIENT-CONNECTION-ID attribute1	FIRST-ASYNC-REQUEST attribute
FIRST-PROCEDURE attribute1	LAST-ASYNC-REQUEST attribute	LAST-PROCEDURE attribute1
NAME attribute	NEXT-SIBLING attribute	PREV-SIBLING attribute
PRIVATE-DATA attribute	SSL-SERVER-NAME attribute	SUBTYPE attribute
TYPE attribute
For this attribute to be valid, the handle must have an AppServer or Web service connection (the CONNECTED( ) method must return TRUE).

Methods

CANCEL-REQUESTS( ) method	CONNECT( ) method (AppServer)
CONNECT( ) method (Web service)	CONNECTED( ) method
DISCONNECT( ) method

Note

For SpeedScript, as in any 4GL client, a WebSpeed Agent can use a valid server handle to access and run remote procedures on an AppServer. However, it does not access or affect the state of any WebSpeed Transaction Server.